home *** CD-ROM | disk | FTP | other *** search
/ Gold Medal Software 3 / Gold Medal Software - Volume 3 (Gold Medal) (1994).iso / comms / tlxana10.arj / TLXANA10.DOC < prev    next >
Text File  |  1994-02-15  |  23KB  |  614 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.           | TLXANA (TeLiX ANAlyzer)   v1.00
  10.           |
  11.           | A TELIX.use analyzer 
  12.           |
  13.           | February 15, 1994 ( Radu Caulea )
  14.           |
  15.           | Documentation printed on February 1, 1994
  16.  
  17.  
  18.  
  19.  
  20.  
  21. TLXANA.DOC                     Page 1                      Contents
  22. -------------------------------------------------------------------
  23.  
  24.                                      Contents
  25. Introduction  . . . . . . . . .  . . . . . . . . . . . . . . .   1
  26. Contacting the author  . . . . . . . . . . . . . . . . . . . .   2
  27. ACKNOWLEDGEMENTS . . . . . . . . . . . . . . . . . . . . . . .   3
  28. Notes  . . . . . . . . . . . . . . . . . . . . . . . . . . . .   4
  29. What does it cover ?   . . . . . . . . . . . . . . . . . . . .   5
  30. What it doesn't cover  . . . . . . . . . . . . . . . . . . . .   5
  31. Why use TLXANA?  . . . . . . . . . . . . . . . . . . . . . . .   6
  32. What is the problem? . . . . . . . . . . . . . . . . . . . . .   6
  33. What is the solution?. . . . . . . . . . . . . . . . . . . . .   6
  34. System Requirements  . . . . . . . . . . . . . . . . . . . . .   6
  35. Default files involved in using TLXANA . . . . . . . . . . . .   7
  36. Installing TLXANA  . . . . . . . . . . . . . . . . . . . . . .   8
  37. Using TLXANA   . . . . . . . . . . . . . . . . . . . . . . . .   8
  38. Command-Line Usage  . . .  . . . . . . . . . . . . . . . . . .   9
  39. Files' meaning. . . . . .  . . . . . . . . . . . . . . . . . .  10
  40. Organizing a price file. . . . . . . . . . . . . . . . . . . .  11
  41. Registration  . . . . . .  . . . . . . . . . . . . . . . . . .  13
  42. Registration form . . . .  . . . . . . . . . . . . . . . . . .  14
  43.  
  44. TLXANA.DOC                     Page 2         Contacting the author
  45. -------------------------------------------------------------------
  46.  
  47. TLXANA v1.00                                               
  48.  
  49. Contacting the author
  50. ---------------------
  51. This documentation will tell what you need to know about using
  52. TLXANA. Should you have further questions, please direct them the to
  53. me:
  54.      
  55.      Electronic mail:
  56.           Compuserve:    73631,303
  57.  
  58.      Mail to:
  59.           Radu Caulea
  60.           9, Allee de L'Elephant
  61.           Le Champ Tortu              
  62.           77184 EMERAINVILLE
  63.           FRANCE
  64.  
  65.      Phone : + (33 1) 64 62 97 02  
  66.      Fax/BBS + (33 1) 64 11 99 85
  67.  
  68.      (My BBS is located in FRANCE, so be aware of your communication 
  69.      rates when logging in)
  70.  
  71. When reporting a bug, please be specific as to the nature of the
  72. problem:
  73.      - Part of the analyzed file
  74.      - Error message
  75. TLXANA.DOC                     Page 3              Acknowledgements
  76. -------------------------------------------------------------------
  77.  
  78. The author makes no claims as to the suitability of this product for
  79. any application.  In case of malfunction, the author's liability
  80. shall be limited to a replacement or refund.
  81.  
  82. It is your responsibility to find out if the program will work
  83. reliably on your equipment and for your particular business
  84. environment.  That is why evaluation copies are made available to
  85. you.  This software probably has bugs; no significant software has
  86. ever been produced without them.  If you feel that this program can
  87. be improved in some way, we are open to your ideas.  If you discover
  88. a problem, please send a copy of your program file to us, and we will
  89. attempt to fix the problem.  Anyhow, your remedy for any problem is
  90. limited to the purchase price paid to Radu Caulea.
  91.  
  92.  
  93. TLXANA v1.00 was compiled using Borland C++ v3.0.  
  94. The editor used was Norton Editor & the Borland Integrated Editor.
  95. =====================================================================
  96.  
  97. TELIX is copyrighted by DeltaComm Development, PO Box 1185 Cary, NC
  98. 27512. You must contact DeltaComm for Telix related questions. See
  99. Telix BBS number on page 5 (Notes). 
  100.  
  101.  
  102. TLXANA.DOC                     Page 4                         Notes
  103. -------------------------------------------------------------------
  104.  
  105.  
  106. Notes:
  107. ------
  108. You may distribute TLXANA freely or for a small transportation fee
  109. (in fact, I would appreciate your doing so), provided that you
  110. distribute only the full, unmodified archive (TLXANAXX.ZIP), with its
  111. full intact name (XX stands for release #) containing the following
  112. files:  
  113.  
  114.           TLXANA.DOC (this file)
  115.           TLXANA.EXE (main program)
  116.           TLXANA.PAY (sample communication fees)
  117.           TLXANA.TCM (sample telecom report)
  118.           TLXANA.STT (sample statistics report)
  119.           TLXANA.XMP (example - it is a sample TELIX.USE file)
  120.  
  121. Feel free to distribute TLXANA in other archive formats (such as
  122. LHARC, PAK, LZH, etc.) - but again, you must retain the full name,
  123. as in TLXANAXX.LZH or TLXANAXX.ARJ.
  124.  
  125. If you're not sure whether you have the latest version of TLXANA, the
  126. following systems (among others) are always kept up to date:
  127.      
  128. TELIX Support BBS (DeltaComm Development)     (919) 481-9399
  129. Compuserve IBMCOM Forum (as TLXANA.ARJ)
  130. My BBS (Develo(p)er BBS)                + (33 1) 64 11 99 85
  131.  
  132. (My BBS is located in FRANCE, so be aware of your communication rates
  133. when logging in)        
  134.  
  135. If after a reasonable period of time you wish to continue using it,
  136. please consider filling out and sending in the registration form at
  137. the end of this document. You'll be supporting shareware, making
  138. possible future improved versions of this and other programs; you
  139. will also receive the latest registered version of TLXANA, including
  140. features not present in the Shareware version (see "What Doesn't It
  141. Cover," below).  For further details, see the Registration section
  142. at the end of this document.
  143.  
  144. I would also like to know, even if you don't want to register
  145.  
  146.      Is there something you don't like about TLXANA?  
  147.      Is there something missing? (related to its purpose)
  148.      Are there any features you would like it to have?
  149.      Is the documentation incomplete? 
  150.  
  151. Thank you for your feed-back
  152. TLXANA.DOC                     Page 5     What does it cover or not
  153. -------------------------------------------------------------------
  154.  
  155.  
  156. What does it cover?
  157. ====================
  158.  
  159. Today only english version of TELIX.USE is covered. Please send to
  160. the author a list of messages that may appear in a foreign version.
  161.  
  162. The shareware version
  163. ---------------------
  164.  
  165. Analysis of TELIX.use producing
  166.  
  167.      1.   Telecom like tracking of all calls including date, time,
  168.           time online, price
  169.  
  170.      2.   Statistics concerning all calls, BBSes, total time on-line
  171.  
  172.      3.   Some reminder for registering
  173.  
  174. You can also purge inconsistent paragraphs from TELIX.USE
  175.  
  176. The registered version
  177. ---------------------------------------------
  178. Everything in the registered version plus :
  179.  
  180.      1.   Statistics regarding uploads, downloads (average speeds)
  181.  
  182.      2.   Tracking and statistics regarding up/downloaded files
  183.  
  184.      3.   No register reminder
  185.  
  186.      4.   Total amount of money spent on every BBS
  187.  
  188. What doesn't it cover? (Yet)
  189. =============================
  190.  
  191.      1.   TLXANA assumes that the time in TELIX.USE appears in
  192.           military format (24 hrs) - feature used in calculating
  193.           prices/communications
  194.  
  195.      2.   Connections begun yesterday and finished today.
  196.  
  197.      3.   Statistics for incoming calls (for those interested in
  198.           using TELIX as a managing tool for mailers, faxes, BBSes)
  199.  
  200.      4.   Currency. Today you will see over the prices' column the
  201.           $ sign. Future versions will use preferences.
  202.  
  203. Of course your opinion will be very useful for deciding the following
  204. aspects:
  205.  
  206.      1.   New features in future versions
  207.  
  208.      2.   Design of future versions 
  209. TLXANA.DOC                     Page 6               Why use TLXANA?
  210. -------------------------------------------------------------------
  211. Why use TLXANA?
  212.  
  213.      What is the problem?
  214.      -------------------
  215.  
  216. 1.   I have been using TELIX for quite a time, but since I bought a
  217.      New Speedy Modem, my TELECOM bills are enormously long and
  218.      expensive, because I logged in overseas, and online time and
  219.      price increased vertiginously.
  220.  
  221. 2.   Sometimes TELIX exits from a communication "forgetting" to
  222.      specify the "elapsed time online" information.
  223.  
  224. 3.   Often I tune my HOST+ environment and TELIX.LOG is full of
  225.      unnecessary information.
  226.  
  227. 4.   My BBS being based on Host+ (the TELIX mini BBS), I wanted to
  228.      have some statistics related to its usage.
  229.  
  230.  
  231.  
  232.      What is the solution?
  233.      --------------------
  234.  
  235. A program that might successfully and most completely :
  236.  
  237. 1.   Correct the logging missing information.
  238. 2.   Calculate the prices per communication.
  239. 3.   Offer the possibility to purge unnecessary paragraphs in
  240.      TELIX.USE
  241. 4.   Offer statistics in respect with past connections.
  242.   
  243. System Requirements
  244. -------------------
  245.      IBM PC compatible
  246.      MS-DOS 3.0 or above, or DR-DOS 5 or above
  247.      TELIX
  248.      60 K of free RAM or more.  
  249.      Any monitor and disk drive setup supported by TELIX
  250. TLXANA.DOC                     Page 7    Default files involved ...
  251. -------------------------------------------------------------------
  252.  
  253. The default files involved in using TLXANA are:
  254.  
  255. TLXANA.EXE          necessary
  256.      Program used for analyzing TELIX.USE
  257.  
  258. TLXANA.PAY          optional
  259.      File containing prices per minute of communication, depending
  260.      on different prefixes and daily periods.     
  261.  
  262. TLXANA.TLC          created by TLXANA   
  263.      Telecom file tracking all the connections in TELIX.USE and
  264.      prices when possible.
  265.  
  266. TLXANA.STT          created by TLXANA   
  267.      Statistics file - Statistics for TELIX connections including
  268.      Connect Phones, Names, Time connected, Downloads, Uploads
  269.  
  270. TLXANA.USE          created by TLXANA
  271.      New log file. It is TELIX.USE file with some paragraphs purged.
  272.      You would like to rename it as TELIX.USE later.
  273.  
  274. TLXANA.TRS          created by TLXANA
  275.      Trash file. It contains the paragraphs purged from TLXANA.USE
  276.  
  277. TELIX.USE           necessary
  278.      TELIX log file - created by TELIX  
  279.  
  280.  
  281. TLXANA.DOC                     Page 8       Installing/using TLXANA
  282. -------------------------------------------------------------------
  283.  
  284. Installing TLXANA
  285.  
  286. You should decompress the original file normally received in a
  287. compressed form with the specific file decompressor.
  288.  
  289. You can do that directly in the TELIX directory or in another
  290. directory (for testing) 
  291.  
  292. Files inside the archive are named TLXANAXX.YYY, where 
  293.      XX  stands for version and
  294.      YYY stands for specific use
  295.  
  296.  
  297.  
  298. Using TLXANA
  299.  
  300. The easiest, most automatic way to use TLXANA is to start TLXANA in
  301. the TELIX.USE directory with no command line parameters
  302.      
  303.                          TLXANA
  304.  
  305. TLXANA will    1) read the TELIX.USE file
  306.                2) create a statistics file and a telecom file
  307.  
  308. You must have TELIX.USE in your TLXANA.EXE directory.
  309.  
  310. If you do not have TELIX.USE (strange), rename the TLXANA.XMP file
  311. (found in the archive) as TELIX.USE
  312.  
  313.  
  314. TLXANA.DOC                     Page 9                  Command line
  315. -------------------------------------------------------------------
  316.  
  317. TLXANA accepts a list of parameters/files on the command line 
  318.  
  319. .1   /uFile    (/UFile)
  320. ------------------------------------
  321. Specifies the TELIX usage file to be processed
  322.      If no /u found on the command line, or 
  323.      If no valid File is found, default is TELIX.USE
  324.  
  325. .3   /pFile    (/PFile)
  326. ------------------------------------
  327. Specifies the TELIX purged usage file
  328.  
  329. If no /p found on the command line, no purge of TELIX.USE is done
  330. unless you specify /m (see below)
  331.  
  332. If File is not specified, default is TLXANA.PRG
  333. After the treatment, you might want to rename TLXANA.PRG as TELIX.USE
  334.  
  335. .4   /gFile    (/GFile)
  336. ------------------------------------
  337. Specifies the TELIX trash usage file, it contains paragraphs purged
  338. from TELIX.USE (for verification only).
  339.  
  340. If no /g found on the command line, no purge of TELIX.USE is done
  341. unless you specify /p or /m (see below)
  342.  
  343. If File is not specified, default is TLXANA.TRS
  344.  
  345. .5   /tFile    (/TFile)
  346. ------------------------------------
  347. Specifies the TELIX TELECOM usage file
  348. If no /t found on the command line, default is TLXANA.TCM 
  349. If File is not specified, default is TLXANA.TCM
  350.  
  351. .6   /sFile    (/Sfile)
  352. ------------------------------------
  353. Specifies the TELIX usage statistics file
  354. If no /s found on the command line, default is TLXANA.STT  
  355. If File is not specified, default is TLXANA.STT
  356.  
  357. .7   /$File 
  358. ------------------------------------
  359. Specifies prices for connect time 
  360. If no /$ found on the command line, default is TLXANA.PAY 
  361. If File is not specified, default is TLXANA.PAY
  362. If no valid file exists, all calculated prices will be zero
  363.  
  364. .7   /m        (/M)
  365. ------------------------------------
  366. Specifies if purging TELIX.USE is done manually or automatically
  367. If no /M but /P or/and /g found on the command line, default is
  368. automatic purge
  369. TLXANA.DOC                     Page 10             Meaning of files
  370. -------------------------------------------------------------------
  371. Files
  372. -----
  373.  
  374. /p[File]                                    (example /pTLXANA.PRG)
  375.  
  376. Specifies the file where consistent paragraphs of TELIX.USE are to
  377. be written. Consistent paragraphs are lines between "TELIX usage log
  378. opened" and "TELIX usage file closed" which specify that significant
  379. events occurred: connections, down/uploading, connect time > 0, etc.
  380. By default (no /P) no purging is done
  381.  
  382. Note:     A /p, even with no file specified, will purge
  383.           inconsistent paragraphs writing the default
  384.           files.
  385. /m
  386. Specifies if a manual purge will be done 
  387. When specifying /m, program will prompt for action for each
  388. paragraph:
  389.  
  390.                "Keep paragraph ? [Y/N], default is yes"
  391.  
  392. A paragraph consists of TELIX.USE lines between 
  393.      TELIX usage log opened and
  394.      TELIX usage log closed
  395.  
  396. Any keyboard input will KEEP the paragraph, (write it to /PFile)
  397. except N/n which will purge the paragraph   (write it to /GFile).
  398.  
  399. You might want to rename TLXANA.PRG as TELIX.USE after verifications
  400.  
  401. /g[File]  (garbage file)                     (example /gTLXANA.TRS)
  402.  
  403. Specifies the file where inconsistent paragraphs of TELIX.USE are
  404. to be written. Inconsistent paragraphs are lines between "TELIX usage
  405. log opened" and "TELIX usage file closed" which specify that nothing
  406. have occurred: no connections, no down/uploading, connect time = 0,
  407. etc.
  408.  
  409. Note:     A /g, even with no file specified, will purge
  410.           inconsistent paragraphs writing the default
  411.           files.
  412.  
  413. /t[File]                                     (example /tTLXANA.TCM)
  414. Specifies the file where every connection is interpreted and price
  415. for that connection is calculated based on prices /minute /phone
  416. prefix found in TLXANA.PAY (see below)
  417.  
  418. TLXANA "repairs" connection logs where lines are missing
  419. Sometimes my TELIX.USE file doesn't have the "total online" line, due
  420. to a brutal disconnection or a hangup. In these cases TLXANA
  421. calculates the total minutes online from available information:
  422. connect time,hangup time, usage log closed time, etc.
  423. TLXANA.DOC                     Page 11      Organizing a price file
  424. -------------------------------------------------------------------
  425.  
  426. /$File                                       (example /$TLXANA.PAY)
  427. Specifies the file were prices for communications are found.
  428. Prices are listed in the form:
  429. ---------------------------------------------------------
  430. Prefix    HH:MM-HH:MM FMin. FPrice. EMin. EPrice.
  431. ---------------------------------------------------------
  432.           All lines containing a "//" are ignored,
  433.           regardless of the double slash's position 
  434. Where :
  435. PREFIX
  436. ------
  437.      is prefix or a prefix followed by some digits as it appears in
  438.      the phone directory of TELIX
  439.      Example:  Suppose that a TELIX number has a +341-xxx-xxx form.
  440.                If prefix +34-1- is found in the /$File, every
  441.                connection in /uFile ("connected with .. at phone
  442.                +34-1-xxx-xxxx") will be analyzed on the basis of
  443.                +34-1- price.
  444.      
  445.      You might have also a line containing +341-514- of course, the
  446.      TELIX.use file will be analyzed for that number *IF* the most
  447.      complete prefix is listed before the least complete prefix  
  448.  
  449.      Example:  Suppose you have two entries for connecting in
  450.                Germany with BBS situated in different regions. 
  451.  
  452.           The prefix for Germany is +34.
  453.           Suppose you know the exact price for connecting in one
  454.           specific region, but not for the others, (although for
  455.           international calls, prices for different regions don't
  456.           differ  enormously)
  457.  
  458.           The two numbers listed in TELIX.FON are
  459.                +34-1-514-1234 and
  460.                +34-1-921-678
  461.  
  462.           1.   If prefix listed in /pFile is +34-1, prices will be
  463.                calculated on the +34-1 basis, regardless of region
  464.                for the Germany calls (+34-1 prefix)
  465.           2.   If prefix listed in /pFile are 
  466.                     +34-1 ................
  467.                     +34-1-514 ...........,
  468.                prices will be calculated on the +341 basis,
  469.                regardless of region for the Germany calls (+341
  470.                prefix)
  471.           3.   If prefix listed in /pFile are
  472.                     +34-1-514 ........................
  473.                     +34-1-    .......................,
  474.                prices will be calculated on the +34-1-514 basis for
  475.                34-1-514- called numbers, and on the +34-1- basis for
  476.                all other regions in Germany
  477.  
  478.      For every number used in TELIX.USE whose prefix is not listed
  479.      in /pFile, a zero price will be calculated.
  480. TLXANA.DOC                     Page 12      Organizing a price file
  481. -------------------------------------------------------------------
  482.  
  483. HH:MM-HH:MM
  484. -----------
  485.      Specifies beginning and end of periods when prices are
  486.      calculated.
  487.      This might be interesting for cheaper connections.
  488.      For one specific prefix you might enter several lines for prices
  489.      containing different periods and prices
  490.      If the connection time found in TELIX.USE doesn't fit any period
  491.      specified in /pFile, a 0 price will  be calculated
  492.  
  493. FMin, Fprice
  494. ------------
  495.      Specify the First period and price for it at connect.
  496.      Generally, Phone companies charge a first period at a certain
  497.      price different from the next periods price
  498.  
  499. Emin, Eprice
  500. ------------
  501.      Specify price per period after the Fmin period (see above)
  502.      Example:
  503.           +341- 08:00-19:00 1.5 3. 0.75  1.
  504.      means that For calling a +341-xxxx number between 8 a.m. and 7
  505.      p.m. you will have to pay $3. /minute the first 1.5 minutes and
  506.      $1.00 every 45 seconds (.75 minutes)
  507.  
  508. Generally, during the first FMin period, the whole period is billed,
  509. regardless of real connect time
  510.  
  511. If in your area there is not a whole period charge for the first Fmin
  512. period of time, you would enter Fmin equal to Emin and Fprice equal
  513. to Eprice. 
  514.  
  515. TLXANA.DOC                     Page 13                 Registration
  516. -------------------------------------------------------------------
  517.  
  518. Registration
  519.  
  520.           NOTE: TLXANA may NOT be used in a business or commercial
  521.           environment without registration.
  522.  
  523.      TLXANA is distributed as shareware.  The advantage of this is
  524. that you get to try out the full, working program and see whether or
  525. not it suits your needs.  If you find TLXANA useful, you must
  526. register the program.  Registration has some benefits: you will
  527. receive the latest version of TLXANA on disk, along with inexpensive
  528. on-disk updates to future versions. Comments, suggestions, and
  529. requests from registered users will of course have high priority.
  530.    
  531.      To register TLXANA, just fill out the registration form below;
  532. be sure to include your check or money (15 (see note 1) US Dollars
  533. or 60 French Francs), and mail it to the address below.  Basic
  534. registration is ten dollars, including shipping, handling, and the
  535. cost of a floppy disk (3 1/2", MS-DOS DS/DD, with the latest version
  536. of TLXANA).  Of course, once you've registered one version of TLXANA,
  537. you've registered all future versions as well -- so you can simply
  538. download the latest version from a BBS. I provide the upgrade service
  539. for those who can't find the latest version elsewhere.
  540. -----------------------------------------------------------------
  541.  
  542. Note 1) 
  543. Price includes the approx $5 bank fee when cashing a foreign check 
  544. ------------------------------------------------------------------
  545.  
  546. International money transfer problems
  547. -------------------------------------
  548.  
  549. Please do not hesitate because of the often discussed complications
  550. of foreign money orders, international bankers' cheques etc..
  551. Simply take a cheque form from your own usual bank-account, add 5 $
  552. or so to cover the international cheque fees (cashed in by the
  553. author's bank) and send the cheque with your order to the author
  554. (airmail, please, in case of letters from USA to Europe).
  555.  
  556.      Thank you for registering TLXANA.
  557.      The registration form follows.
  558.  
  559.  
  560.  
  561.  
  562. TLXANA.DOC                     Page 14            Registration form
  563. -------------------------------------------------------------------
  564.  
  565. Please send this form, along with your check or money for the
  566. appropriate amount of US dollars or French Francs, to:
  567.  
  568.      Radu Paul CAULEA                                              
  569.      9, Allée de L'Eléphant                                        
  570.      77184 EMERAINVILLE
  571.      FRANCE
  572.  
  573. I would like to register TLXANA in the following manner:
  574.   __ Regular registration (with the latest version on disk)       
  575.      For $15.00 or 60 French Francs (please specify currency)
  576.  
  577. Name:               
  578.  
  579. ___________________________________________________
  580. Company:            
  581.  
  582. ___________________________________________________
  583. Street Address:     
  584.  
  585. ___________________________________________________
  586. City, ST:           
  587.  
  588. ___________________________________________________
  589.  
  590. Zip:                _____________
  591.  
  592. Home phone number (optional): (_____)-______________
  593.  
  594. Work phone number (optional): (_____)-______________
  595.  
  596. CIS  address (optional):    ________________________
  597.  
  598. Where did you find TLXANA? 
  599.  
  600. ___________________________________________
  601. Comments and/or Suggestions:  
  602.  
  603. _______________________________________________________________
  604.      
  605.  
  606. _________________________________________________________________
  607.      
  608.  
  609. _________________________________________________________________
  610.      
  611.  
  612. __________________________________________________________________
  613.  
  614.